home *** CD-ROM | disk | FTP | other *** search
/ BCI NET 2 / BCI NET 2.iso / archives / utilities / time / event.lha / Event / Event.doc < prev    next >
Encoding:
Text File  |  1994-09-19  |  5.4 KB  |  247 lines
  1.  
  2.  
  3.  
  4.                             Event´er  1.14
  5.                             ==============
  6.                              18-Sep-94 mk
  7.  
  8.  
  9.  
  10. Preface
  11. -------
  12. The program and files in this distribution are freely distributable,
  13. but are also copyright (c) by Klaus Muckenhuber. They may be freely
  14. distributed as long as no more than a nominal fee is charged to cover
  15. time and copying costs.
  16.  
  17. No commercial usage is permitted without written permission from the
  18. author.  Everything in this distribution must be kept together, in original
  19. unmodified form.
  20.  
  21. The above is generally known as freeware.
  22.  
  23. Please contact me if you have any comments or suggestions !!
  24.  
  25.  
  26.  
  27. Disclaimer
  28. ----------
  29. No warranties of any kind are made as to the functionality of this
  30. program.  You are using it at your own risk.
  31.  
  32.  
  33.  
  34. Information:
  35. ------------
  36. With this software you have a good tool to remember everything you want.
  37.  
  38.  
  39.  
  40. Features:
  41. ---------
  42. * requiers only 12 kB memory
  43. * the event´s are storend in a data file
  44. * multitasking friendly
  45. * "gliding" event´s
  46. * loading only the Event´s from the current day
  47.  
  48.  
  49. Installation:
  50. -------------
  51. 1. step
  52. Copy the hole drawer on your disk.
  53.     Workbench:    move the drawer icon with the mouse (drag & drop)
  54.     CLI:        copy df0:Event SYS:tools/Event all
  55.  
  56.  
  57. 2. step
  58. Add in your "S:user-startup" file the following lines
  59.  
  60. ; Startup Event´er
  61. run >NIL: SYS:tools/Event
  62.  
  63.  
  64. 3. step
  65. put in the "S:" directory your data file.
  66.  
  67.  
  68.  
  69. Data-File
  70. ---------
  71.  
  72. Note:    At first Event´er search the data-file in the local directory,
  73.         second looking in the "S:" directory.
  74.  
  75.         The data-file must be named as "Event.data"
  76.  
  77.  
  78. The Data-File has the following description
  79.  
  80. 1. line            Delay time between the event test (default value=50)
  81.                 Normally the value is set on 50 == 1 sec.
  82.                 If you want saving your CPU power set the value 
  83.                 on "200" ~2 sec´s
  84.                 You can set the value between -2147483646 and 2147483647 (int)
  85.                 Every value under 0 will have the same effect!
  86. 2. line            Delay time between the data file test. (default value=60)
  87.                 Normally it will be set the value an 60 == 60 sec.
  88.                 If you edit the file mostly you can set the value on a short
  89.                 number, otherwise you can set a high value if you dont want
  90.                 update from the datafile.
  91.                 You can set the value between -2147483646 and 2147483647 (int)
  92. 3. line; first Event        Event TYP
  93. 4. line; first Event        Event DATE
  94. 5. line; first Event         Event TIME
  95. 6. line; first Event         Event MESSAGE
  96. 7. line; second Event        Event TYP
  97. ...                            ..
  98. .....                        ....
  99. .....
  100.  
  101.  
  102.  
  103. Event TYP: (these are Flags, combinations are possible)
  104. 0        normal (aktiv DisplayBeep + Requester)
  105. 1        No DisplayBeep
  106. 2        No Requester
  107. 4        Quit Event´er 
  108. 8        Event Weekday
  109.         If you set this flag the value for the day will be interpreted as weekday
  110.         -1.-1.00    every Sonday
  111.         -1.-1.01    every Monday
  112.         -1.-1.02    every Tuesday
  113.         -1.-1.03    every Wednesday
  114.         -1.-1.04    every Thursday
  115.         -1.-1.05    every Friday
  116.         -1.-1.06    every Saturday
  117.  
  118.     Examples for typ:
  119.         0    normal setup
  120.         9    No DisplayBeep, and Weekday
  121.         10  No Requester (only DisplayBeep) and Weekday
  122.  
  123.  
  124. Event DATE:
  125.     Format: yy.mm.dd  (Year.Month.Day)
  126.     ie: 94.09.27
  127.  
  128. Event TIME:
  129.     Note: 24 Hours only (no am/pm shit)
  130.     Format: hh:mm:ss
  131.     ie: 16:55:09
  132.  
  133. Event MESSAGE:
  134.     You can enter everything you want - but only the first 60 characters are
  135.     loaded and displayed!
  136.  
  137.  
  138.  
  139. Spezial Feature:
  140. ----------------
  141.     With the "-1" statement by date or time you tell Event´er a gliding Event
  142.  
  143.     DATE
  144.     94.09.10    means 1994 September 10
  145.     94.09.-1    means every day in September 1994
  146.     94.-1.-1    means evers day 1994
  147.     -1.-1.01    means on each first month day 
  148.     -1.04.05    means every year the 4 day in may (ie: birthday..)
  149.     -1.-1.-1    means every Day
  150.  
  151.     DATE with set typ=8 (Weekday)
  152.     94.09.01    means every Monday in September 1994
  153.     94.-1.06    means every Saturday 1994
  154.     -1.-1.-1    means every Day
  155.     -1.01.05    means every Year in January every Friday
  156.     
  157.  
  158.     TIME
  159.     -1:00:00    means every full hour 
  160.     13:-1:00    means every minute in the time between 13:00:00 and 13:59:00
  161.     13:00:-1    means every second in the time between 13:00:00 and 13:00:59
  162.     -1:-1:00    means every full minute every hour
  163.     -1:15:00    means every hour 15 mins past beginning
  164.             and so on....
  165.  
  166.  
  167.  
  168. Example "Event.data" File:
  169. ------------------------
  170. 50    ;delay between event test (1/50 sec)
  171. 60    ;delay between data filetest (1 sec)
  172. 0
  173. 94.10.04
  174. 19:00:00
  175. normal event like, gudrun to cinema! money?
  176. 1
  177. -1.-1.-1
  178. 20:15:00
  179. looking in television, or forget it!
  180. 0
  181. -1.-1.-1
  182. 23:30:00
  183. YOU MUST GO TO BED!!!
  184. 2
  185. -1.-1.-1
  186. 22:59:00
  187. dummy; only a warning - no message
  188. 9
  189. -1.-1.01
  190. 17:00:00
  191. every Monday, training!
  192. 2
  193. -1.-1.-1
  194. 23:11:-1
  195. one minute - DisplayBeep!!!
  196. 8
  197. -1.-1.00
  198. 19:10:00
  199. Computerclub, only Sunday
  200. 0
  201. -1.05.04
  202. -1:00:00
  203. Birthday Mike !!!
  204. 4    ;Quit 
  205. 99.-1.-1
  206. -1:-1:-1
  207. set >99< to the current year - save it - Event´er will exit!
  208.  
  209.  
  210.  
  211. Remember:    Every minute Event´er will test your datafile about any
  212.             modifcation, and if was modified Event´er will reload the 
  213.             file.
  214.  
  215.             Do not enter empty lines - every event must have 4 lines!
  216.  
  217.             WATCH ON CORRECT SYNTAX!
  218.  
  219.             Only minimal tested - attension - no garantie!!
  220.  
  221.  
  222.  
  223. Hint:        If you want, make a graphics interface for Event´er
  224.             to edit the date file (Event.data)
  225.                 * no commodity
  226.                 * seperate process
  227.                 * if you do that - send it to me also!
  228.  
  229.  
  230. History:
  231. --------
  232. 18-Sep-94  1.14     added the weekday support
  233. 17-Sep-94  1.05     added date support
  234. 15-Sep-94  1.02  added the QUIT feature
  235. 12-Sep-94  1.01     added the automatic load feature
  236. 11-Sep-94  1.0     first realease (privat)
  237.  4-Sep-94        the idea
  238.  
  239.  
  240.  
  241. The Author:
  242. -----------
  243.     Klaus Muckenhuber
  244.     Markt 37
  245.     A-4625 OFFENHAUSEN
  246.     AUSTRIA
  247.